<?php
/** 
 * @version V4.93 10 Oct 2006 (c) 2000-2010 John Lim (jlim#natsoft.com). All rights reserved.
 * Released under both BSD license and Lesser GPL library license. 
 * Whenever there is any discrepancy between the two licenses, 
 * the BSD license will take precedence. 
 *
 * Set tabs to 4 for best viewing.
 * 
 * Latest version is available at http://php.weblogs.com
 *
 * Requires PHP4.01pl2 or later because it uses include_once
*/

/*
    Filter all fields and all rows in a recordset and returns the 
    processed recordset. We scroll to the beginning of the new recordset
    after processing.
    
    We pass a recordset and function name to RSFilter($rs,'rowfunc');
    and the function will be called multiple times, once
    for each row in the recordset. The function will be passed
    an array containing one row repeatedly.
    
    Example: 
     
    // ucwords() every element in the recordset
    function do_ucwords(&$arr,$rs)
    {
        foreach($arr as $k => $v) {
            $arr[$k] = ucwords($v);
        }
    }
    $rs = RSFilter($rs,'do_ucwords');
 */
function RSFilter($rs,$fn)
{
    if ($rs->databaseType != 'array') {
        if (!$rs->connection) return false;
        
        $rs = $rs->connection->_rs2rs($rs);
    }
    $rows = $rs->RecordCount();
    for ($i=0; $i < $rows; $i++) {
        if (is_array ($fn)) {
            $obj = $fn[0];
            $method = $fn[1];
            $obj->$method ($rs->_array[$i],$rs);
      } else {
            $fn($rs->_array[$i],$rs);
      }
      
    }
    if (!$rs->EOF) {
        $rs->_currentRow = 0;
        $rs->fields = $rs->_array[0];
    }
    
    return $rs;
}
?>